home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d7
/
cmodem44.arc
/
RCMODEM.DOC
< prev
next >
Wrap
Text File
|
1990-10-31
|
10KB
|
345 lines
------------------------------------------------------------------------------
C C H L L - M O D E M
rC-MODEM v4.40
------------------------------------------------------------------------------
Hanns Ludwig Lippmann Cultural Center (CCHLL) 1989,1990
Lavio Pareschi - all rights reserved
As a shareware program, this is not to be to sold or held. DISTRIBUTE IT !
------------------------------------------------------------------------------
QUICK START
----- -----
rcmodem
-it will ask you a few questions
rcmodem /p=1/rx
-com1 port, receive a file at current subdir
rcmodem /p=1/tx c:\path\filename
-com1 port, transmit filename
rcmodem /p=2/s=q/tsr
-com2 port, size of block = quick, stay resident
rcmodem /p=1/tx
-com1 port, transmit automatic to CSBbs (no need local name)
-------------------------------------------------------------------------------
FEATURES
--------
>> MAJOR Features of this Ibm-PC communications asynchronous protocol :
. crash recovery
. speed!
. optimum block size math calculated
. easy multiple files specification
1 - Transmission CRASH Recovery
If interrupted by any factor, the file transmitted is saved with the
extension file.BAD until the last byte is received correctly.
In the next connection/transmission, the file will be completed automatically.
2 - VARIABLE DATA : data blocks of optimum variable size, calculated.
Depending on the speed and errors during transmission, as well as line
noise, the size of the data-blocks between crc-blocks will vary between
32 to 4096 bytes.
This reduces the amount of control bytes added to the transmission and
minimizes data repetition.
The result is an excellent, true transfer rate.
3 - FULL duplex
The transmitter side does not stop on every block to receive useless answers.
The transmission occurs without pauses between blocks.
The receiver only warns when something goes wrong.
4 - ERRORS/BYTE/CALLS
Starts the data blocks size with the expected value.
Uses statistical calculations to find the optimum block size based on time,
errors, and calls accumulated numbers.
5 - RESIDENT, if wanted
It can stay resident and called up by:
ctrl-up : uploads
ctrl-down: downloads
ctrl-ins : change parameters
6 - MULTIPLE FILES
1. Only need to edit the file "tx_file.txt" with the filenames and use the
/multi switch
2. Wildcards "/tx file*.*" allow multiple files selection
------------------------------------------------------------------------------
FILES IN THIS PACKAGE: CMODEMxx.COM (Lharc self extract):
RCMODEM.EXE
Executable file to be used as an external protocol (Msdos).
RCSETUP.EXE
To set up and create "cmodem.cfg", a configuration file.
RCSTOP.EXE
To send ctrl-Xs to stop transmitter at the other size.
RCMODEM.DOC
This doc file.
RXPCPL.BAT
Batch file for ProcomPlus (download).
TXPCPL.BAT
Batch file for ProcomPlus (upload).
RX.BAT & TX.BAT
Batch files for use via Dos, with any communications package that
allows DOS access during connection and use of COM interrupt vectors.
RXBBS.BAT & TXBBS.BAT and others
Batch file examples for use in BBSs.
SHARE.TXT
Shareware concepts and registration.
EXAMPLES.DOC
Quick command examples.
-------------------------------------------------------------------------------
COMMANDS
rC-Modem [switches] [filepathname]
Switches:
/p=i/rx/tx/b=n/off/bbs/n=i/pause/tsr/s=x/quit/d=i/log/bios/multi/old/l=i
/dcd/cts
^
|___ Note: NO spaces between switches
/p=i : PORT 1(com1), 2(com2), 3 or 4. Default = 1.
/rx : for downloads, default.
. it is not necessary to type the filename during downloads,
the transmitter will do the job.
/tx : for uploads.
filepathname needed unless /csb is used
/b : BAUD = 300, 1200, 2400, 4800 or 9600 or 0
. initializes the serial port with baud, parity, stop and word length.
. if not specified, the existing configuration of the serial port will be
automatically detected and used
. if b=0, then no baud detection will be made, being unknown, and it will
use the remaining existing configuration of the serial port.
. the goal of "b=0" is to disrrupt the auto baud detection, if this
is not correct, as it relies on hardware.
. it may be possible to achieve better efficiency if this paramater is used
to pinpoint the correct baud rate in any case.
/off : turns off the CRASH recovery function (it will OVERWRITE any file
that was not completely transmitted)
/bbs : no vector ctrl-break, (default is to vector)
reports to CMODEM.LOG
. no change in ctrl-break and ctrl-C interrupt vectors.
. no pause and alarm on return
/n=i : NOISE expected (from 0=low to 10=high)
Default uses cmodem.dat (recommended)
/pause : pause (20 secs) and alarm before return (default = no pause)
/tsr : stay resident
Hot keys:
ctrl-down: downloads
ctrl-up : uploads
ctrl-ins : change parameters as "/param1/param2..."
/quit : to remove the rcmodem from memory if /tsr was used
/s=q or /s=c : determines the way to change size blocks
. q = quick.
. c = calculate the optimum size, default.
/d=i : internal delays extended "i" seconds, range = {0,30}, default = 0
maybe useful in delayed phone lines
/log : report to CMODEM.LOG
useful to log up/downs activities
bbs utility
/bios : no direct video (default direct)
/multi : use files edited in TX_FILES.TXT to transmit (see example file)
/old : use with cmodem versions 1,2,3.x
If not used, the default:
. automatic tx, the filepathname is not necessary
. the subdir used will be the current.
. must be used with CSBbs
/l=i : disable circular msg when /l=0
default on
/dcd : disable carrier checks
default enabled
/cts : disable cts line check
default enabled
filepathname = path and name of file to be transmitted
. necessary when specifying /tx (upload), unless /csb is used.
. if present for /rx, then has priority over filename from transmitter.
. wildcards allow multiple files
COM PORTS:
Com1 : 3F8 - 3FF - IRQ4
Com2 : 2F8 - 2FF - IRQ3
Com3 : 3E8 - 3EF - IRQ4 (non standard)
Com4 : 2E8 - 2EF - IRQ3 (non standard)
-------------------------------------------------------------------------------
GUIDELINES:
>>> PROCOMPLUS <<<
TXPCPL.BAT:
rcmodem /tx/p=1 %1
- in setting up Procomm Plus (Tm DataStorm Technologies Inc.) you may use
txpcpl.bat as an external protocol.
- starting an upload, ProcommPlus will ask you a filename to transmit,
which will be recognized by the parameter %1 used in the .bat file.
- no filename is needed during the download
- you may edit those .bat files to configure it correctly according to your
system.
GTPOWER, QMODEM, ZCOMM, MIRROR, TELIX, TELEMATE and others.
- access the DOS shell
- give the .bat command:
> RX (to download) or
> TX filename (to upload)
this will execute the external protocol.
--- RESIDENT ---
Install using the /tsr switch, BEFORE you run your comunication software:
rcmodem /tsr/p=1 ... for example
Use the hot-keys, as explained, to upload, download and change parameters.
--- BBSs ---
- returns error level 0 if transmission ends ok
- returns error level 1 if transmission ends bad
- creates CMODEM.LOG (only if /bbs is selected).
--- RECOVERY ---
Aborted transmissions give the file x the name x.BAD <-- IMPORTANT
So, no confusion is made.
If you want to recover a file aborted with another protocol, rename to file.BAD
and try rC-Modem!
-------------------------------------------------------------------------------
CMODEM.DAT (see switches /s=c and /s=q)
Statistical methods and some math give us an optimum size of the data blocks,
to mimimize losses due to overheads on control blocks and repeated blocks
because of noise.
A file "cmodem.dat" saves the data as follows:
Format: x y z (ascii) to track the call conditions.
x = seconds accumulated
y = errors due to noise
z = calls
With these values, we can calculate the data block size.
Important: Leave the file cmodem.dat in the same sub-dir of rcmodem.exe .
-------------------------------------------------------------------------------
SHAREWARE
You and your friends are welcome to share and evaluate this package. This
documentation must go with all copies of this shareware. To avoid problems,
it is highly recommended that rC-MODEM is ONLY distributed in this package
with the same files. It can be packed in any kind of compressor as long as
the package integrity is not damaged. Should any anormality in the package
be noticed, please notify the board's operator.
REGISTRATION
After an evaluation period, *ethical* users M U S T register their copy of
this package. They can do it by sending a US$24 bill (see SHARE.TXT).
Upgrades are US$10,00 for registered users.
Contact the CSB-BBS for more informations please.
1: (021) 246-9961
2: 286-2237
3: 286-2242
-------------------------------------------------------------------------------
CCHLL & CSB
Caixa Postal 34.045, CEP 22.472, RJ - BRAZIL
---------------------------- < end of document > -----------------------------